home *** CD-ROM | disk | FTP | other *** search
/ Plug-In Power Pack for Netscape Communicator / Plug-In Power Pack for Netscape Communicator.iso / plugins / dataviews / dvdraw / examples / datasource / dsdllreadme.txt < prev    next >
Text File  |  1997-05-27  |  4KB  |  114 lines
  1.     Integrating Your Data Model into DV-Draw
  2.  
  3.  
  4. In the integration stage, you must:
  5.  
  6.     Coordinate the DLL name and location with the
  7.     corresponding Variable in the registry.
  8.  
  9.     If you want to run views using your data model, create a
  10.     companion Run DLL to support your data model.
  11.  
  12.  
  13. Setting the Registry Key 
  14.  
  15. When you install DV-Draw, the installation specifies the default 
  16. data source DLL in the registry. In order to use your custom 
  17. data source DLL, you must change the DSDLLNAME registry key
  18. setting before you start DV-Draw. You can use your system's 
  19. registry editor to do this. The DSDLLNAME registry key can be set
  20. in one of two places.
  21.  
  22. When you start DV-Draw, the executable checks the registry for the 
  23. location of the data source DLL and loads that DLL. If no data 
  24. source DLL is found, DV-Draw issues a message and the resulting 
  25. instance of DV-Draw has no data-related functionality. No 
  26. warning message appears. However, you can verify what DLL is in 
  27. use by selecting the "About" option under the Help Menu. If no 
  28. data source DLL is in use, the entry says "NO DATA COMPONENT 
  29. LOADED."
  30.  
  31. By default, DV-Draw looks for the data source DLL specified by the 
  32. following path in the registry:
  33.  
  34.     HKEY_CURRENT_USER
  35.       Software
  36.         DataViews
  37.           DV-Draw
  38.             9.8
  39.               General
  40.                 DSDLLNAME
  41.  
  42. If no DLL is found by looking under HKEY_CURRENT_USER, DV-Draw 
  43. looks under HKEY_LOCAL_MACHINE, using the following path:
  44.  
  45.     HKEY_LOCAL_MACHINE
  46.       Software
  47.         DataViews
  48.           DV-Draw
  49.             9.8
  50.               General
  51.                 DSDLLNAME
  52.  
  53. The name of the default data source DLL is DataSource.dll. If 
  54. the name is specified using an absolute path, that file is used. 
  55. If the name is specified without any path information, DV-Draw 
  56. uses LoadLibrary to search the directories specified by the search 
  57. path. 
  58.  
  59. When you install DV-Draw, the installation specifies the default 
  60. data source DLL using HKEY_LOCAL_MACHINE, and does not specify 
  61. anything under HKEY_CURRENT_USER. Therefore, if no DLL is 
  62. specified for the current user, DV-Draw uses the DLL specified 
  63. under HKEY_LOCAL_MACHINE. By explicitly setting HKEY_CURRENT_USER, 
  64. you can specify different paths or different data source DLL names 
  65. for different users. 
  66.  
  67. Given these factors, there are numerous ways to set up the 
  68. registry to make DV-Draw find the data source DLL you want it to 
  69. use:
  70.  
  71. You can store your data source DLL in the same directory as the 
  72. default DV-Draw data source DLL and change the name of the data 
  73. source DLL specified by the default path in the registry. For this 
  74. method, your data source DLL must have a different name from the 
  75. default data source DLL.
  76.  
  77. You can store your data source DLL in a separate directory and 
  78. change the search path specified in the registry. The directory of 
  79. the desired DLL should appear before the directory where the 
  80. default DLL is located. For this method, your data source DLL 
  81. should have the same name as the default data source DLL.
  82.  
  83. You can set up the HKEY_CURRENT_USER information so that 
  84. specific users can use different DLLs. For this method, your 
  85. data source DLL can have a different name from the default data 
  86. source DLL and be in the same directory as the default data source 
  87. DLL, or it can have any name in any other directory.
  88.  
  89. If your data model is significantly different from the default
  90. DV-Draw data model, and if you want to run views using your data
  91. model, you must create a companion Run DLL to support your data model.
  92. For information about creating a companion Run DLL, see the
  93. "Customizing the DV-Draw Data Model" chapter.
  94.  
  95. As with the data source DLL, you must set the appropriate registry 
  96. key in order to make DV-Draw use your custom Run DLL. As discussed
  97. in the previous section, DV-Draw looks for the run DLL specified
  98. by the following path:
  99.  
  100.     HKEY_CURRENT_USER - or - HKEY_LOCAL_MACHINE
  101.       Software
  102.         DataViews
  103.           DV-Draw
  104.             9.8
  105.               General
  106.                 RUNDLLNAME
  107.  
  108. Use the registry editor to set the RUNDLLNAME registry key under the 
  109. HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE path. For more information 
  110. about where DV-Draw looks for the RUNDLLNAME registry key and how 
  111. you can set this registry key to make DV-Draw use your custom Run DLL, 
  112. see the "Setting the Registry Key" section.
  113.  
  114.